##############################################################################
###+-------+##################################################################
#+-| BOF() |-----------------------------------------------+##################
#| +-------+ Returns TRUE if record pointer was moved past |##################
#|           the beginning of file for current alias       |##################
#+---------------------------------------------------------+##################
##############################################################################
##############################################################################
#+--| Summary |------------------+############################################
#|     #INCLUDE database.hdr     |############################################
#+-------------------------------+############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------+###################################
#|     FUNCTION LOGICAL bof PROTOTYPE     |###################################
#+----------------------------------------+###################################
##############################################################################
##############################################################################
####+---| Description |--------------------------------------------------+####
####| The bof() function returns TRUE if the last SKIP operation for the |####
####| the current alias caused the record pointer to try to access       |####
####| record 0, the beginning of the file.  The BOF flag is cleared on   |####
####| the next successful SKIP operation.                                |####
####| ------------------------------------------------------------------ |####
####| When programming with multiple aliases,use of the a_bof() function |####
####| instead of the bof() function may create more readable code.       |####
####+--------------------------------------------------------------------+####
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Results assume database is not empty.               |#########
#########|                                                          |#########
#########| GOTO BOTTOM                                              |#########
#########| ? bof()                    && Prints .f.                 |#########
#########| GOTO TOP                                                 |#########
#########| ? bof()                    && Prints .f.                 |#########
#########| SKIP -1                                                  |#########
#########| ? bof()                    && Prints .t.                 |#########
#########+----------------------------------------------------------+#########
##############################################################################